Skip to content

[ZIP 227, ZIP 230] Clarify usage and encoding of issuance validating keys and issuer identifiers#1053

Merged
daira merged 10 commits intozcash:mainfrom
daira:zsa-227-and-230
Jul 29, 2025
Merged

[ZIP 227, ZIP 230] Clarify usage and encoding of issuance validating keys and issuer identifiers#1053
daira merged 10 commits intozcash:mainfrom
daira:zsa-227-and-230

Conversation

@daira
Copy link
Copy Markdown
Collaborator

@daira daira commented Jul 16, 2025

Based on #1048 with additional changes from the ZIP Editors.

fixes #969

vivek-arte and others added 6 commits June 27, 2025 22:20
This PR updates the diagram of the relation between the issuance
validating key, asset description and asset identifier to correctly
describe the changes made in zcash#1042. It also responds to two
comments that were added post the merge of that PR.
… to `issuer`, and renaming it to "issuer identifier" (zcash#114)

This PR makes the changes mentioned in ZIP 227, ZIP 230, and the
relevant image files.
This PR makes the changes requested in zcash#1048.
This PR makes updates to ZIP 246 (aka the V6 SIGHASH algorithm) based on
the changes being made as a part of zcash#1048. A minor broken link is
also fixed.
* Undo changes to the Issuance Keys specification section concerning
  `issuer`, and put them in a new `Issuance Identifier` section instead.
* Similarly undo changes to `Derivation of issuance validating key` since
  those are covered by `Issuance Identifier`.
* Remove an inapplicable reference `[#protocol-addressesandkeys]` (which
  describes the spend authority key tree, not the issuance key tree).
* Be more precise about the distinction between the encodings of issuance
  signatures / public keys and their abstract values. This allows the
  abstract values to be identical to BIP 340 while still supporting
  algorithm extensibility.
* Clarify which consensus rule changes apply only when there is an issuance
  bundle, and reword a fragile reference to the "sixth rule".

Co-authored-by: Jack Grigg <jack@electriccoin.co>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
@daira daira force-pushed the zsa-227-and-230 branch from b5b1f0b to 5f94884 Compare July 16, 2025 23:01
ZIPs 226 and 227, and other cosmetic changes.

Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
@daira daira force-pushed the zsa-227-and-230 branch from 5f94884 to ba3e37a Compare July 16, 2025 23:07
@daira daira changed the title [Draft] Updates to ZIPs 227 and 230 [ZIP 227, ZIP 230] Clarify usage and encoding of issuance validating keys and issuer identifiers Jul 16, 2025
Comment thread zips/zip-0227.rst Outdated
nuttycom and others added 2 commits July 29, 2025 15:12
Co-authored-by: Vivek Arte <46618816+vivek-arte@users.noreply.github.com>
Co-authored-by: Kris Nuttycombe <kris@nutty.land>
Co-authored-by: Jack Grigg <jack@electriccoin.co>
Co-authored-by: Arya <aryasolhi@gmail.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
Copy link
Copy Markdown
Contributor

@nuttycom nuttycom left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK 54d0a42

@nuttycom nuttycom marked this pull request as ready for review July 29, 2025 22:02
@daira daira merged commit 1016834 into zcash:main Jul 29, 2025
1 check passed
@daira daira deleted the zsa-227-and-230 branch July 29, 2025 22:16
ConstanceBeguier added a commit to QED-it/orchard that referenced this pull request Sep 1, 2025
…es (#182)

This PR makes the updates to the encoding of the issuance validating key
and the issuance authorization signature, as done in the specification
in zcash/zips#1042, along with the further updates in zcash/zips#1048
and zcash/zips#1053.

The test vectors are updated in QED-it/zcash-test-vectors#31.

---------

Co-authored-by: Constance Beguier <constance@qed-it.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ZSAs: Addition of reference notes to the global issuance state to prepare for ZSA Swaps

4 participants